
<!DOCTYPE HTML>
<html lang="" >
    <head>
        <meta charset="UTF-8">
        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
        <title>/add, /del, ... · GitBook</title>
        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
        <meta name="description" content="">
        <meta name="generator" content="GitBook 3.2.3">
        
        
        
    
    <link rel="stylesheet" href="../gitbook/style.css">

    
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-highlight/website.css">
                
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-search/search.css">
                
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-fontsettings/website.css">
                
            
        

    

    
        
    
        
    
        
    
        
    
        
    
        
    

        
    
    
    <meta name="HandheldFriendly" content="true"/>
    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
    <meta name="apple-mobile-web-app-capable" content="yes">
    <meta name="apple-mobile-web-app-status-bar-style" content="black">
    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="../gitbook/images/apple-touch-icon-precomposed-152.png">
    <link rel="shortcut icon" href="../gitbook/images/favicon.ico" type="image/x-icon">

    
    <link rel="next" href="method.html" />
    
    
    <link rel="prev" href="paths.html" />
    

    </head>
    <body>
        
<div class="book">
    <div class="book-summary">
        
            
<div id="book-search-input" role="search">
    <input type="text" placeholder="Type to search" />
</div>

            
                <nav role="navigation">
                


<ul class="summary">
    
    

    

    
        
        
    
        <li class="chapter " data-level="1.1" data-path="../">
            
                <a href="../">
            
                    
                    OpenAPI 文档结构
            
                </a>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="1.1.1" data-path="openapi.html">
            
                <a href="openapi.html">
            
                    
                    openapi
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.1.2" data-path="info.html">
            
                <a href="info.html">
            
                    
                    info
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.1.3" data-path="paths.html">
            
                <a href="paths.html">
            
                    
                    paths
            
                </a>
            

            
            <ul class="articles">
                
    
        <li class="chapter active" data-level="1.1.3.1" data-path="url.html">
            
                <a href="url.html">
            
                    
                    /add, /del, ...
            
                </a>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="1.1.3.1.1" data-path="method.html">
            
                <a href="method.html">
            
                    
                    get, post, ...
            
                </a>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="1.1.3.1.1.1" data-path="parameters.html">
            
                <a href="parameters.html">
            
                    
                    parameters
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.1.3.1.1.2" data-path="requestBody.html">
            
                <a href="requestBody.html">
            
                    
                    requestBody
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.1.3.1.1.3" data-path="responses.html">
            
                <a href="responses.html">
            
                    
                    responses
            
                </a>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="1.1.3.1.1.3.1" data-path="response_code.html">
            
                <a href="response_code.html">
            
                    
                    200, 400, ...
            
                </a>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="1.1.3.1.1.3.1.1" data-path="content.html">
            
                <a href="content.html">
            
                    
                    content
            
                </a>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="1.1.3.1.1.3.1.1.1" data-path="media.html">
            
                <a href="media.html">
            
                    
                    text/plain
            
                </a>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="1.1.3.1.1.3.1.1.1.1" data-path="schema.html">
            
                <a href="schema.html">
            
                    
                    schema
            
                </a>
            

            
        </li>
    

            </ul>
            
        </li>
    

            </ul>
            
        </li>
    

            </ul>
            
        </li>
    

            </ul>
            
        </li>
    

            </ul>
            
        </li>
    

            </ul>
            
        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="1.1.4" data-path="components.html">
            
                <a href="components.html">
            
                    
                    components
            
                </a>
            

            
        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="1.2" data-path="../schema/">
            
                <a href="../schema/">
            
                    
                    常见的 schema 规则
            
                </a>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="1.2.1" data-path="../schema/string.html">
            
                <a href="../schema/string.html">
            
                    
                    字符串
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.2.2" data-path="../schema/number.html">
            
                <a href="../schema/number.html">
            
                    
                    数字
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.2.3" data-path="../schema/json.html">
            
                <a href="../schema/json.html">
            
                    
                    json object
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.2.4" data-path="../schema/array.html">
            
                <a href="../schema/array.html">
            
                    
                    数组
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.2.5" data-path="../schema/boolean.html">
            
                <a href="../schema/boolean.html">
            
                    
                    布尔值
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.2.6" data-path="../schema/combining.html">
            
                <a href="../schema/combining.html">
            
                    
                    组合
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.2.7" data-path="../schema/ref.html">
            
                <a href="../schema/ref.html">
            
                    
                    引用
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.2.8" data-path="../schema/generic.html">
            
                <a href="../schema/generic.html">
            
                    
                    通用
            
                </a>
            

            
        </li>
    

            </ul>
            
        </li>
    

    

    <li class="divider"></li>

    <li>
        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
            Published with GitBook
        </a>
    </li>
</ul>


                </nav>
            
        
    </div>

    <div class="book-body">
        
            <div class="body-inner">
                
                    

<div class="book-header" role="navigation">
    

    <!-- Title -->
    <h1>
        <i class="fa fa-circle-o-notch fa-spin"></i>
        <a href=".." >/add, /del, ...</a>
    </h1>
</div>




                    <div class="page-wrapper" tabindex="-1" role="main">
                        <div class="page-inner">
                            
<div id="book-search-results">
    <div class="search-noresults">
    
                                <section class="normal markdown-section">
                                
                                <h1 id="add-del-">/add, /del, ...</h1>
<p>&#x4E00;&#x4E2A;&#x63A5;&#x53E3;&#x4E0B;&#x9762;&#x53EF;&#x80FD;&#x6709;&#x591A;&#x4E2A;&#x8BF7;&#x6C42;&#x65B9;&#x6CD5;&#xFF0C;&#x4E0D;&#x540C;&#x7684;&#x8BF7;&#x6C42;&#x65B9;&#x6CD5;&#xFF0C;&#x5BF9;&#x5E94;&#x7684;&#x76F8;&#x5E94;&#x5185;&#x5BB9;&#x53EF;&#x80FD;&#x4E0D;&#x4E00;&#x6837;&#x3002;&#x6BD4;&#x5982;http&#x63A5;&#x53E3;&#x8C03;&#x7528;&#x5982;&#x679C;&#x6D89;&#x53CA;&#x5230;&#x8DE8;&#x57DF;&#x8DE8;&#x57DF;&#x7684;&#x8BDD;&#xFF0C;&#x4E00;&#x822C;&#x4F1A;&#x5148;&#x7528;option&#x65B9;&#x6CD5;&#x67E5;&#x8BE2;&#x63A5;&#x53E3;&#x662F;&#x5426;&#x652F;&#x6301;&#x8DE8;&#x57DF;&#xFF0C;&#x7136;&#x540E;&#x518D;&#x8FDB;&#x884C;&#x5B9E;&#x9645;&#x7684;post&#xFF0C;put&#x7B49;&#x8BF7;&#x6C42;&#x64CD;&#x4F5C;</p>
<pre><code class="lang-yaml"><span class="hljs-attr">paths:</span>
  /add:
<span class="hljs-attr">    get:</span>
      <span class="hljs-comment"># &#x63CF;&#x8FF0; get &#x63A5;&#x53E3;</span>
<span class="hljs-attr">    put:</span>
      <span class="hljs-comment"># &#x63CF;&#x8FF0; put &#x63A5;&#x53E3;</span>
<span class="hljs-attr">    post:</span>
      <span class="hljs-comment"># &#x63CF;&#x8FF0; post &#x63A5;&#x53E3;&#x7B49;</span>
</code></pre>
<p>&#x5B8C;&#x6574;&#x5B57;&#x6BB5;</p>
<pre><code class="lang-yaml"><span class="hljs-attr">paths:</span>
  /add:
<span class="hljs-attr">    summary:</span> string <span class="hljs-comment"># &#x6458;&#x8981;</span>
<span class="hljs-attr">    description:</span> string <span class="hljs-comment"># &#x63CF;&#x8FF0;</span>
<span class="hljs-attr">    get:</span> 
      <span class="hljs-comment"># &#x8BF7;&#x6C42;&#x65B9;&#x6CD5;&#xFF0C;put&#xFF0C; post&#xFF0C;delete</span>
<span class="hljs-attr">    servers:</span>
      <span class="hljs-comment"># &#x670D;&#x52A1;&#x5668;&#x5BF9;&#x8C61;</span>
<span class="hljs-attr">    parameters:</span>
<span class="hljs-bullet">      -</span> <span class="hljs-comment"># &#x8BF7;&#x6C42;&#x53C2;&#x6570;</span>
</code></pre>
<p>&#x4F60;&#x53EF;&#x80FD;&#x4F1A;&#x6CE8;&#x610F;&#x5230; &#x8DEF;&#x5F84;&#x4E0B;&#x9762;&#x4E5F;&#x6709;&#x4E2A; <code>servers</code> &#x5BF9;&#x8C61;&#xFF0C;oepanpi &#x6839;&#x7ED3;&#x6784;&#x4E0B; &#x4E5F;&#x6709;&#x4E2A; <code>servers</code> &#x5BF9;&#x8C61;&#xFF0C;&#x5B83;&#x4EEC;&#x6709;&#x4EC0;&#x4E48;&#x533A;&#x522B;&#x5462;&#xFF1F;&#x5B83;&#x4EEC;&#x662F;&#x4E00;&#x6837;&#x7684;&#xFF0C;&#x53EA;&#x4E0D;&#x8FC7;&#x4E00;&#x4E2A;&#x5168;&#x5C40;&#x9ED8;&#x8BA4;&#x7684;&#xFF0C;&#x4E00;&#x4E2A;&#x5C40;&#x90E8;&#x7279;&#x5B9A;&#x7684;&#xFF0C;&#x7C7B;&#x4F3C;&#x4E8E;&#x53D8;&#x91CF;&#xFF0C;&#x5C40;&#x90E8;&#x7684;&#x4F1A;&#x8986;&#x76D6;&#x5168;&#x5C40;&#x7684;&#x3002;&#x8FD8;&#x6709;&#x4E00;&#x4E9B;&#x5B83;&#x7684;&#x5B57;&#x6BB5;<code>parameters</code>&#xFF0C;<code>security</code>  &#x7B49;&#xFF0C;&#x90FD;&#x662F;&#x7C7B;&#x4F3C;&#x7684;&#x539F;&#x7406;&#x3002;</p>

                                
                                </section>
                            
    </div>
    <div class="search-results">
        <div class="has-results">
            
            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
            <ul class="search-results-list"></ul>
            
        </div>
        <div class="no-results">
            
            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
            
        </div>
    </div>
</div>

                        </div>
                    </div>
                
            </div>

            
                
                <a href="paths.html" class="navigation navigation-prev " aria-label="Previous page: paths">
                    <i class="fa fa-angle-left"></i>
                </a>
                
                
                <a href="method.html" class="navigation navigation-next " aria-label="Next page: get, post, ...">
                    <i class="fa fa-angle-right"></i>
                </a>
                
            
        
    </div>

    <script>
        var gitbook = gitbook || [];
        gitbook.push(function() {
            gitbook.page.hasChanged({"page":{"title":"/add, /del, ...","level":"1.1.3.1","depth":3,"next":{"title":"get, post, ...","level":"1.1.3.1.1","depth":4,"path":"openapi/method.md","ref":"openapi/method.md","articles":[{"title":"parameters","level":"1.1.3.1.1.1","depth":5,"path":"openapi/parameters.md","ref":"openapi/parameters.md","articles":[]},{"title":"requestBody","level":"1.1.3.1.1.2","depth":5,"path":"openapi/requestBody.md","ref":"openapi/requestBody.md","articles":[]},{"title":"responses","level":"1.1.3.1.1.3","depth":5,"path":"openapi/responses.md","ref":"openapi/responses.md","articles":[{"title":"200, 400, ...","level":"1.1.3.1.1.3.1","depth":6,"path":"openapi/response_code.md","ref":"openapi/response_code.md","articles":[{"title":"content","level":"1.1.3.1.1.3.1.1","depth":7,"path":"openapi/content.md","ref":"openapi/content.md","articles":[{"title":"text/plain","level":"1.1.3.1.1.3.1.1.1","depth":8,"path":"openapi/media.md","ref":"openapi/media.md","articles":[{"title":"schema","level":"1.1.3.1.1.3.1.1.1.1","depth":9,"path":"openapi/schema.md","ref":"openapi/schema.md","articles":[]}]}]}]}]}]},"previous":{"title":"paths","level":"1.1.3","depth":2,"path":"openapi/paths.md","ref":"openapi/paths.md","articles":[{"title":"/add, /del, ...","level":"1.1.3.1","depth":3,"path":"openapi/url.md","ref":"openapi/url.md","articles":[{"title":"get, post, ...","level":"1.1.3.1.1","depth":4,"path":"openapi/method.md","ref":"openapi/method.md","articles":[{"title":"parameters","level":"1.1.3.1.1.1","depth":5,"path":"openapi/parameters.md","ref":"openapi/parameters.md","articles":[]},{"title":"requestBody","level":"1.1.3.1.1.2","depth":5,"path":"openapi/requestBody.md","ref":"openapi/requestBody.md","articles":[]},{"title":"responses","level":"1.1.3.1.1.3","depth":5,"path":"openapi/responses.md","ref":"openapi/responses.md","articles":[{"title":"200, 400, ...","level":"1.1.3.1.1.3.1","depth":6,"path":"openapi/response_code.md","ref":"openapi/response_code.md","articles":[{"title":"content","level":"1.1.3.1.1.3.1.1","depth":7,"path":"openapi/content.md","ref":"openapi/content.md","articles":[{"title":"text/plain","level":"1.1.3.1.1.3.1.1.1","depth":8,"path":"openapi/media.md","ref":"openapi/media.md","articles":[{"title":"schema","level":"1.1.3.1.1.3.1.1.1.1","depth":9,"path":"openapi/schema.md","ref":"openapi/schema.md","articles":[]}]}]}]}]}]}]}]},"dir":"ltr"},"config":{"gitbook":"*","theme":"default","variables":{},"plugins":["livereload"],"pluginsConfig":{"livereload":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"}},"file":{"path":"openapi/url.md","mtime":"2020-08-17T06:07:42.072Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2020-08-17T10:32:10.207Z"},"basePath":"..","book":{"language":""}});
        });
    </script>
</div>

        
    <script src="../gitbook/gitbook.js"></script>
    <script src="../gitbook/theme.js"></script>
    
        
        <script src="../gitbook/gitbook-plugin-livereload/plugin.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-search/search-engine.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-search/search.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-sharing/buttons.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
        
    

    </body>
</html>

